BMS-MS Teams integration

Introduction

The BMS integration with Microsoft Teams provides users with an alternate method for receiving the notifications generated by ticket workflow rules. Instead of a mailbox, the notification is sent to a webhook URL and posted to a Microsoft Teams channel. The workflow rules define the events and conditions as well as the Teams channel the notification is posted to.

Each post contains a variation of the following information:

  • Ticket Number

  • Event (This is either "ticket created on" date or "updated on" date. The date displayed related to the event will be one of these.)

  • Ticket Title

  • Account (In case of a contact, then the format will be contact.account.) In case there is no contact present, then the format is just 'Account.'

  • Description

  • Primary Resource (If there is no primary resource, then the ticket falls back on to the queue.)

  • Priority

  • Status

  • Note Added by

  • Note Date

  • Time Added by

  • Time Log Date

  • Time Spent

  • Expense Added by

  • Expense Date

  • Expense Type

  • Expense Amount

  • Due Date (All dates and time are displayed based on the time zone of the user.)

Below the information fields are two action buttons:

  • View Ticket

  • Add Time Entry

Clicking a button will open the respective ticket or new time entry popup in BMS. If you are not logged in, you will be asked to authenticate.

Configuration

To set up the integration, the following steps are required in BMS and Microsoft Teams:.

Do the following on the Teams' side:

Configuring Incoming Webhooks in Teams

In Microsoft Teams, you can set up the team and channel or channels that will generate the webhooks that establish the connection to BMS and receive the notifications.

To create a webhook for a channel, do the following. (This is according to the New Teams. For steps according to Classic Teams, see Create an Incoming Webhook under this link and go to Classic Teams tab.)

  1. In a Teams channel, click the More options menu and select Manage channel.

  2. Select Edit.


  3. Search for Incoming Webhook and select Add.

    The Incoming Webhook dialog appears.

  4. Select Add.

    NOTE  If you’ve already added an Incoming Webhook, the Configure option appears. Select Configure to create an Incoming Webhook.

  5. Provide a name for the webhook and upload an image if necessary.

  6. Click Create.

    NOTE  If you want to use the BMS logo, right-click the above image, select Save image as and save it with a name of your choice. Then, you can upload the image.

  7. Copy and save the unique webhook URL present in the dialog. The URL maps to the channel and you can use it to send information to Teams.

  8. Click Done. The webhook is now available in the Teams channel.

Creating Teams Channel Connectors in BMS

Once the incoming webhook URLs are set up in Teams, the connectors must be set up in BMS.

  1. Go to Admin > My Company > Microsoft Teams.

  2. Click New. The Manage Teams Channel page opens.

  3. Name: Enter a channel name.

  4. Description: Enter a brief description for the channel.

  5. Channel Webhook URL: Enter the same webhook URL that you copied earlier. Once you paste the URL, you can also test the connection by clicking Test Connection.

  6. Failure Notification Email: Enter a valid email to be notified in case of failure.

  7. Click Save.

Setting up Workflow Rules to Post Notifications to Teams

The final step is to configure ticket workflow rules to post notification emails to a Teams channel instead of, or in addition to, sending an email notification.

  1. Create or edit a ticket workflow rule. For more information, see Getting started with workflows.

    NOTE  In this first iteration, tickets are the only entities that are supported.

  2. Go to General tab > Triggers tab > Notifications tab of the workflow rule form.

  3. In the section called Channels, select the appropriate checkboxes under Microsoft Teams Channel.

  4. Click Save. Every time the workflow rule fires, the notification will be posted to the selected channels.

Failure Notification Emails

In case a notification fails two times or five times to send itself, a failure notification email is sent to the email provided inside the teams channel which failed.

In case a notification fails six times to send itself, a disabled notification email is sent to the email provided inside the teams channel which failed.

Limitations and Restrictions

Supported Entities

At this time, only tickets are supported.

Number of Channels

Each customer can create up to 100 Microsoft Teams connections in BMS.

Message Size and Rate

On the Microsoft side, the following limits and restrictions apply:

Parameter Limit
Message Size 28 KB
Rate

4 messages/second

60 messages/30 seconds

3,600 messages/hour

86,400 messages/day